Scenario #3100: Create Sepa Mandate for Debitor

UseCase Create Sepa Mandate For Debitor => SEPA-Mandate: Test AG

Properties

Required

Given

name value
debitorNumber D-3101000
mandateReference Test AG - main debitor
mandateAgreement 2022-10-12
mandateValidFrom 2024-10-15
bankAccountHolder Test AG - debit bank account
bankAccountIBAN DE02701500000000594937
bankAccountBIC SSKMDEMM

Debitor: Test AG - main debitor

HTTP GET "/api/hs/office/debitors/D-3101000" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "108668cb-b18c-4289-ae6e-c570cf107a0e", // Debitor: D-3101000 - Test AG - main debitor
  "debitorRel" : {
    "uuid" : "478b9771-d325-48eb-9885-125f9111379e",
    "anchor" : {
      "uuid" : "00ddd2fc-8742-46e5-924c-77749d4c8ccc", // Person: Test AG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Test AG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "00ddd2fc-8742-46e5-924c-77749d4c8ccc", // Person: Test AG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Test AG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "DEBITOR",
    "mark" : null,
    "contact" : {
      "uuid" : "e10c2148-a9d5-4cb2-8029-44cfbc2cd5e9",
      "caption" : "Test AG - billing department",
      "postalAddress" : { },
      "emailAddresses" : {
        "main" : "billing@test-ag.example.org"
      },
      "phoneNumbers" : { }
    }
  },
  "debitorNumber" : "D-3101000",
  "debitorNumberSuffix" : "00",
  "partner" : {
    "uuid" : "3da9e2a0-95cc-4ea4-bb4c-e73ad571beb4", // Partner: P-31010 - Test AG
    "partnerNumber" : "P-31010",
    "partnerRel" : {
      "uuid" : "f1943189-716b-46ea-8218-fa169740db15", // partnerRelationUuid
      "anchor" : {
        "uuid" : "806e75fe-7894-4422-86be-783107f07f3f", // Person: Hostsharing eG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Hostsharing eG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "holder" : {
        "uuid" : "00ddd2fc-8742-46e5-924c-77749d4c8ccc", // Person: Test AG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Test AG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "type" : "PARTNER",
      "mark" : null,
      "contact" : {
        "uuid" : "351fc296-c0f1-459a-8730-4a65b9605cee", // Contact: Test AG - China
        "caption" : "Test AG - China",
        "postalAddress" : {
          "country" : "China",
          "province" : "Guangdong Province",
          "city" : "Dongguan City",
          "street" : "No.2 Commercial Second Street",
          "district" : "Niushan Wei Wu",
          "department" : "Executive Board",
          "building" : "Thi Chi Koh Building"
        },
        "emailAddresses" : {
          "main" : "norden@test-ag.example.org"
        },
        "phoneNumbers" : {
          "phone" : "++15 999 654321"
        }
      }
    },
    "details" : {
      "uuid" : "ec212097-b265-4392-b0ad-2806db2beb66",
      "registrationOffice" : "Registergericht Hamburg",
      "registrationNumber" : "1234567",
      "birthName" : null,
      "birthPlace" : null,
      "birthday" : null,
      "dateOfDeath" : null
    }
  },
  "billable" : true,
  "vatId" : "VAT123456",
  "vatCountryCode" : "DE",
  "vatBusiness" : true,
  "vatReverseCharge" : false,
  "refundBankAccount" : {
    "uuid" : "b435c7a1-e6ef-466b-a71e-da7914720743",
    "holder" : "Test AG - refund bank account",
    "iban" : "DE88100900001234567892",
    "bic" : "BEVODEBB"
  },
  "defaultPrefix" : "tst"
}

BankAccount: Test AG - debit bank account

HTTP POST "/api/hs/office/bankaccounts" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  <<EOF
{
  "holder" : "Test AG - debit bank account",
  "iban" : "DE02701500000000594937",
  "bic" : "SSKMDEMM"
}
EOF
=> status: 201 CREATED 8178aff4-e865-40b1-81c9-45c1ae230fd9

Create SEPA-Mandate: Test AG

HTTP POST "/api/hs/office/sepamandates" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  <<EOF
{
  "debitor.uuid" : "108668cb-b18c-4289-ae6e-c570cf107a0e", // Debitor: D-3101000 - Test AG - main debitor
  "bankAccount.uuid" : "8178aff4-e865-40b1-81c9-45c1ae230fd9", // BankAccount: Test AG - debit bank account
  "reference" : "Test AG - main debitor",
  "agreement" : "2022-10-12",
  "validFrom" : "2024-10-15"
}
EOF
=> status: 201 CREATED 79c433a0-3a53-4ecd-97f3-9d46db5e4c7f

generated on 2026-08-10 01:37:53 for branch